home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / DtDtsBufferToAttributeValue.z / DtDtsBufferToAttributeValue
Encoding:
Text File  |  2003-11-18  |  4.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      DDDDttttDDDDttttssssBBBBuuuuffffffffeeeerrrrTTTTooooAAAAttttttttrrrriiiibbbbUUUUuuuuNNNNttttIIIIeeeeXXXXVVVVaaaaSSSSllllyyyyuuuusssseeeetttt((((eeee3333mmmm))))VVVV ((((1111    AAAADDDDuuuuttttggggDDDDuuuuttttssssssssttttBBBBuuuu1111ffff9999ffff9999eeee5555rrrr))))TTTTooooAAAAttttttttrrrriiiibbbbuuuutttteeeeVVVVaaaalllluuuueeee((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       DtDtsBufferToAttributeValue -    get a single data attribute
  10.       value    for a byte stream
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ####iiiinnnncccclllluuuuddddeeee <<<<DDDDtttt////DDDDttttssss....hhhh>>>>
  14.  
  15.       cccchhhhaaaarrrr ****DDDDttttDDDDttttssssBBBBuuuuffffffffeeeerrrrTTTTooooAAAAttttttttrrrriiiibbbbuuuutttteeeeVVVVaaaalllluuuueeee((((ccccoooonnnnsssstttt vvvvooooiiiidddd ****_b_u_f_f_e_r,,,,
  16.                         ccccoooonnnnsssstttt iiiinnnntttt _s_i_z_e,,,,
  17.                         ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_a_t_t_r__n_a_m_e,,,,
  18.                         ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_o_p_t__n_a_m_e))));;;;
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.       The DDDDttttDDDDttttssssBBBBuuuuffffffffeeeerrrrTTTTooooAAAAttttttttrrrriiiibbbbuuuutttteeeeVVVVaaaalllluuuueeee() function returns a data
  22.       attribute value for a    given byte stream.  The    _b_u_f_f_e_r
  23.       argument is a    pointer    to the buffer of the data to be    typed.
  24.  
  25.       The _s_i_z_e argument is the size    of the buffer in bytes.
  26.  
  27.       The _a_t_t_r__n_a_m_e    argument is a name of the attribute.
  28.  
  29.       The _o_p_t__n_a_m_e argument    can be used to specify a name to be
  30.       associated with the buffer.  If the _o_p_t__n_a_m_e argument    is not
  31.       NNNNUUUULLLLLLLL,    it is used as a    pseudo file name in typing; otherwise,
  32.       certain attributes may be returned as    NNNNUUUULLLLLLLL because the
  33.       filename components could not    be determined.
  34.  
  35.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  36.       Upon successful completion, the
  37.       DDDDttttDDDDttttssssBBBBuuuuffffffffeeeerrrrTTTTooooAAAAttttttttrrrriiiibbbbuuuutttteeeeVVVVaaaalllluuuueeee()    function returns a pointer to
  38.       a data attribute value string, or NNNNUUUULLLLLLLL if no value could be
  39.       determined.
  40.  
  41.      AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  42.       The application should use the DDDDttttDDDDttttssssFFFFrrrreeeeeeeeAAAAttttttttrrrriiiibbbbuuuutttteeeeVVVVaaaalllluuuueeee(3)
  43.       function to release the memory for the returned value.
  44.  
  45.       The DDDDttttDDDDttttssssBBBBuuuuffffffffeeeerrrrTTTTooooAAAAttttttttrrrriiiibbbbuuuutttteeeeVVVVaaaalllluuuueeee() function assumes that the
  46.       buffer is readable and writable by the user, group and other
  47.       file classes and selects a type accordingly.    An application
  48.       requiring a type based on read-only permissions should use
  49.       DDDDttttDDDDttttssssDDDDaaaattttaaaaTTTTooooDDDDaaaattttaaaaTTTTyyyyppppeeee().
  50.  
  51.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  52.       DDDDttttDDDDttttssss(5), DDDDttttDDDDttttssssDDDDaaaattttaaaaTTTTooooDDDDaaaattttaaaaTTTTyyyyppppeeee(3), DDDDttttDDDDttttssssLLLLooooaaaaddddDDDDaaaattttaaaaTTTTyyyyppppeeeessss(3),
  53.       DDDDttttDDDDttttssssFFFFrrrreeeeeeeeAAAAttttttttrrrriiiibbbbuuuutttteeeeVVVVaaaalllluuuueeee(3).
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.